home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 9 / FreshFishVol9-CD2.bin / bbs / util / convert-2.01.lha / Convert / OS 1.3 / Convert.doc < prev    next >
Text File  |  1993-12-21  |  16KB  |  391 lines
  1.  
  2.  
  3.                       » » » » »  C O N V E R T  « « « « «
  4.  
  5.                         version 1.2, October 3th, 1992
  6.  
  7.                                  User Manual
  8.  
  9.         ***************************************************************
  10.  
  11.                                   Contents
  12.  
  13.                    1. Introduction - What does "Convert" ?
  14.                    2. Getting started
  15.                    3. Working with "Convert"
  16.                    4. Creating own conversion descriptions
  17.                    5. Error messages
  18.                    6. The shell version "Cvt"
  19.  
  20.  
  21.         ***************************************************************
  22.  
  23.  
  24.         1. Introduction
  25.  
  26.  
  27.         "Convert" is a powerful file conversion program. It covers the
  28.         application domain of all ASCII conversion tools between Amiga
  29.         and MS-DOS or any other computer system. This means, that file
  30.         conversion with "Convert" does NOT affect the physical format of
  31.         a file but only its contents. Physical conversion is not subject
  32.         of "Convert" and thus assigned to tools like "CrossDOS".
  33.  
  34.         "Convert" can be used to replace bytes or pairs of bytes in a
  35.         file by another byte or another pair of bytes or by nothing.
  36.         Therefore it can be used tasks as follows:
  37.  
  38.         - replacing TABs in an ASCII file with blank character(s)
  39.         - stripping controls in an ASCII file
  40.         - converting ASCII-files between Amiga and MS-DOS, MS-DOS and
  41.           Amiga, Amiga and Mac, Mac and Sun, Amiga and Sun etc.
  42.  
  43.         What are "conversion descriptions" ?
  44.  
  45.         All that "Convert" needs, is a set of "replacement records"
  46.         which it can apply to its input files. This set is in the
  47.         following called "conversion description".
  48.         You can create your individual conversion descriptions by
  49.         creating several "replacement records" with a text editor using
  50.         the simple syntax described in Chapter 4. These "records" are
  51.         stored to a conversion description file which can be parsed by
  52.         "Convert".
  53.  
  54.         The draft of specifying the conversion by a simple text file
  55.         makes "Convert" more powerful than any other conversion tool
  56.         and thus allows the application of "Convert" for almost all
  57.         conversion problems.
  58.  
  59.  
  60.         ***************************************************************
  61.  
  62.  
  63.         2. Getting started
  64.  
  65.  
  66.         Installation
  67.  
  68.         To install "Convert" double-click the "Install" icon. This short
  69.         shell script will copy the libraries required by "Convert" into
  70.         the LIBS: directory. The program needs
  71.  
  72.         - arp.library (v39.1),
  73.         - reqtools.library (v38.362 or higher) and
  74.         - intuisup.library (v4.5 or higher).
  75.         
  76.         Furthermore, you must have a directory from where "Convert" reads
  77.         its conversion description files. If this directory is not the
  78.         same as the one where "Convert" is placed, you must assign the
  79.         logical device "CVT:" to it.
  80.         If "Convert" starts, first it looks in the current directory for
  81.         conversion descriptions. If it cannot find any matching file
  82.         (with the extension ".cvt"), it tries to get files from "CVT:".
  83.         NOTE: If "Convert" cannot find any description files, it will
  84.         NOT work !
  85.  
  86.  
  87.         Starting "Convert"
  88.  
  89.         You can start "Convert" by entering its name in the shell or by
  90.         double-clicking its icon.
  91.         If the program can locate at least one conversion description,
  92.         it opens a window which contains the control panel of "Convert".
  93.         This panel consists of following elements:
  94.  
  95.         * Source file list *
  96.  
  97.         This list on the left side of the buttons displays the names of
  98.         all files to be converted. The names are shown without path
  99.         name, except if you select two files in different directories
  100.         with the same name. Then the whole path name is displayed.
  101.  
  102.         * Conversion list *
  103.  
  104.         This list on the right side of the buttons displays the names
  105.         of the conversion description files which "Convert" could locate
  106.         at the start. The currently selected conversion description file
  107.         is shown by a high-lighted selection. By default the first name
  108.         of the list is selected.
  109.  
  110.         * Button "Clear" *
  111.  
  112.         You can use this button for deleting the current contents of the
  113.         source file list. If the files in this list have not been
  114.         converted yet, you will be asked to confirm your decision.
  115.  
  116.         * Button "Add files..." *
  117.  
  118.         If you click this button, a file requester will appear. You can
  119.         then select the files which you want to convert by clicking on
  120.         the file names while holding the SHIFT key. In addition there are
  121.         buttons for selecting and de-selecting all files and for pattern
  122.         matching (absolutely great, Nico !).
  123.         Press the button "Ok" to add the selected files to the source file
  124.         list.
  125.  
  126.         * Button "Remove" *
  127.  
  128.         You can use this button for deleting the currently selected item
  129.         in the source file list. If the files in this list have not been
  130.         converted yet, you will be asked to confirm your decision.
  131.  
  132.         * Button "Start" *
  133.  
  134.         A click on this button starts the conversion process.
  135.  
  136.         * Button "About..." *
  137.  
  138.         Click this button to get short information about "Convert".
  139.  
  140.         * Button "Quit" *
  141.  
  142.         You can use this button for exiting "Convert". If the files in the
  143.         source file list have not been converted yet, you will be asked
  144.         to confirm your decision. You can also quit by clicking in the
  145.         close gadget of "Convert"'s window.
  146.  
  147.         * Cycle-gadget "Replace Original/Target Directory"
  148.  
  149.         This cycle-gadget can be used to toggle between the following two
  150.         modes:
  151.  
  152.         1. replacement mode
  153.         2. duplication mode
  154.  
  155.         The replacement mode is active, when the gadget shows the text
  156.         "Replace Original". Former versions of "Convert" (up to v1.12)
  157.         only provide this mode. In this mode "Convert" replaces the
  158.         original file with the converted version.
  159.         If you choose the duplication mode, a directory requester will
  160.         appear and you have to select a target directory, where "Convert"
  161.         will write the converted files. The name of the target directory
  162.         is then displayed within the cycle-gadget.
  163.  
  164.  
  165.         ***************************************************************
  166.  
  167.  
  168.         3. Working with "Convert"
  169.  
  170.  
  171.         When you have started "Convert" from the shell or from workbench,
  172.         it will open a window which contains a small control panel.
  173.         The source file list on the left side of the buttons is empty,
  174.         so the buttons "Clear" and "Start" are "ghosted".
  175.         Whenever you want to append files to the source file list, press
  176.         the button "Add files". A file requester will appear which allows
  177.         you to select the desired files. Press the "Ok" button to
  178.         append the files to the source file list.
  179.         If you do not want to overwrite the old files with the converted
  180.         versions, then you can specify a target directory for the
  181.         converted files by pressing the cycle-gadget at the botton of the
  182.         window. When you have chosen a target directory, its name will
  183.         be displayed within the gadget.
  184.         Before you start the conversion process, make sure you have
  185.         selected the correct conversion description in the list on the
  186.         right side of the buttons. The current description is shown in
  187.         the string gadget below the list.
  188.         The conversion process can be started by pressing the "Start"
  189.         button. "Convert" will open a window which gives you a simple
  190.         trace about the conversion.
  191.         If the conversion description contains no syntax errors, the
  192.         conversion should be performed without any problem. Otherwise
  193.         you have to correct the description file with a text editor.
  194.         At the end "Convert" informs you with a simple requester about
  195.         the success of the conversion process.
  196.         If there